home *** CD-ROM | disk | FTP | other *** search
/ Chip 1996 October / CHIP 1996 oktober (CD08).zip / CHIP_CD08.BIN / xfree86.os2 / readme.os2 < prev    next >
Text File  |  1996-09-11  |  24KB  |  795 lines
  1.   README for XFree86 3.1.2D on OS/2
  2.   Holger Veit
  3.   Last modified on: 20 Feb 1996
  4.  
  5.   1.  Introductory Note about the ALPHA release 3.1.2D
  6.  
  7.   Before looking into this file, please check for any LATEST.OS2 files
  8.   that may come with the binary distribution. Some statements made here
  9.   refer to the official public version of XFree86/OS2, and may not be
  10.   fully functional in the alpha release.
  11.  
  12.   This version of the code is called XFree86/OS2 3.1.2D. The letter
  13.   ``D'', according to the naming rules of XFree86, usually denotes a
  14.   (public) beta version of the code. Since this is the first public
  15.   version of XFree86/OS2 at all, this code is considered having ALPHA
  16.   quality only.
  17.  
  18.   The purpose of this release is to test it widely without restrictions
  19.   in a large number of configurations and find bugs that are still
  20.   existing in the distribution. It is also intended as a developer's
  21.   platform to port and write applications based on the X11 programming
  22.   interfaces provided here. This release is complete (with one
  23.   exception) regarding the X11R6.1 ``core'' distribution. The
  24.   ``contrib'' distribution containing some of the more interesting tools
  25.   for the end user, will be issued together with a later release (no
  26.   need to start porting it independently).
  27.  
  28.   This version is therefore intended for the experienced and knowledged
  29.   software engineer only, not for a casual end user.
  30.  
  31.   This means - and this should be taken serious - that
  32.  
  33.      o  there is no explicit or implicit warranty that certain code
  34.         works correctly or works at all
  35.  
  36.      o  this code may damage your hardware; this includes improper
  37.         configuration or bugs still present in the software
  38.  
  39.      o  this code may destroy or damage your data on the storage media,
  40.         crash or lock up the operating system and even damage data on
  41.         different disk partitions
  42.  
  43.   You are urged to make a backup of your complete system and keep it in
  44.   a safe place before you attempt to load any of this software on your
  45.   disk.
  46.  
  47.   This even holds if you already have a working copy of XFree86-3.1.2D
  48.   running on another platform, such as Linux, and found it working
  49.   without problems. This is XFree86/OS2 which differs in a number of
  50.   critical aspects from any Unix implementation of XFree86.
  51.  
  52.   If you are afraid to try out this code, simply don't use it and wait
  53.   for a future, hopefully more bug-free version.
  54.  
  55.   2.  What and Where is XFree86?
  56.  
  57.   XFree86 is a port of X11R6 that supports several versions of Intel-
  58.   based Unix.  It is derived from X386 1.2, which was the X server
  59.   distributed with X11R5.  This release consists of many new features
  60.   and performance improvements as well as many bug fixes.  The release
  61.   is available as source patches against the X Consortium X11R6 code, as
  62.   well as binary distributions for many architectures.
  63.  
  64.   XFree86/OS2 is the tentative work title for the implementation of
  65.   XFree86 on OS/2 based systems.
  66.  
  67.   See the Copyright Notice <COPYRIGHT.html>.
  68.  
  69.   Binaries for OS/2 2.11 and OS/2 Warp are available from:
  70.   ftp.XFree86.org:/pub/XFree86/beta/binaries/OS2
  71.   <ftp://ftp.XFree86.org/pub/XFree86/beta/binaries/OS2>
  72.  
  73.   more archives to be added ...
  74.  
  75.   Other versions:
  76.  
  77.   XFree86/OS2 will run on all dialects of Warp, including Warp "red
  78.   spine box", Warp "blue spine box", Warp Connect and Warp Server (beta
  79.   1 and 2). Fixpack level 5 is mandatory, a later fixpack level (10 or
  80.   17) is recommended.  XFree86/OS2 appears to work under OS/2 2.11 with
  81.   fixpack 100, but this was not checked in all details, so hidden
  82.   problems may still exist. It is unlikely that it will run stable under
  83.   OS/2 2.0 and 2.1, and it will definitely not run with any OS/2 1.X.
  84.  
  85.   It is possible to build XFree86/OS2 from the sources.  Read about this
  86.   in some section below.
  87.  
  88.   3.  Bug Reports for This Document
  89.  
  90.   Send email to Holger.Veit@gmd.de (Holger Veit) or XFree86@XFree86.org
  91.   if you have comments or suggestions about this file and we'll revise
  92.   it.
  93.  
  94.   4.  Hardware and Software Requirements
  95.  
  96.   4.1.  Supported, Required, and Recommended Hardware
  97.  
  98.  
  99.      o  At least a 486DX33 with 16MB RAM is required. A Pentium or
  100.         Pentium Pro and more main memory is recommended. A 386 or a
  101.         system with 8MB or less memory is an insufficient configuration.
  102.  
  103.      o  There are no specific requirements concerning network cards,
  104.         disk types, or CD ROM equipment; of course the more powerful,
  105.         the better.
  106.  
  107.      o  Depending on the packages installed, a disk space of 20-55MB on
  108.         a HPFS formatted partition (or a NFS partition natively allowing
  109.         long filenames) is required. XFree86/OS2 will not run on FAT
  110.         partitions.
  111.  
  112.      o  You need a video card that is supported by XFree86. Refer to the
  113.         general README document for a list of supported cards. Note that
  114.         the sets of video cards supported by XFree86 on one hand and
  115.         OS/2 on the other hand overlap, but do not match exactly, i.e.
  116.         the fact that your card is supported by OS/2 does not mean it
  117.         works with XFree86 as well, and vice versa. XFree86 does not use
  118.         the video services of the OS/2 operating system.
  119.  
  120.   4.2.  Required Software
  121.  
  122.  
  123.      o  OS/2 2.11 with fixpack 100 and all versions of Warp with at
  124.         least fixpack level 5 are required.
  125.  
  126.      o  In the version 3.1.2D, you need certain networking TCP/IP
  127.         software.  In a future version, this restriction might be no
  128.         longer present.
  129.  
  130.         1. For OS/2 2.11, IBM TCP/IP 2.0 or later is mandatory.
  131.  
  132.  
  133.         2. Warp comes with the Internet Access Kit (IAK), which is
  134.            sufficient. Warp Connect and Warp Server come with a full
  135.            version of TCP/IP (3.0). Use of this software is preferred
  136.            over IAK then.
  137.  
  138.         Other versions of TCP/IP, such as FTP's, DEC's, or Hummingbird's
  139.         TCP/IP versions, as well as IBM TCP/IP 1.X are not supported.
  140.         Nor does any networking support from DOS (packet drivers,
  141.         winsock), Netware, or NetBIOS work, and I won't to provide sup-
  142.         port for that in the future.
  143.  
  144.      o  If you want to write or port applications for XFree86, you are
  145.         encouraged to do so. You will need a complete installation of
  146.         EMX/gcc 0.9B fix 1 or later for doing so. Neither the second
  147.         (obsolete) implementation of gcc, nor any commercial package,
  148.         including Cset/2, VAC++, Borland C++/OS2, Watcom C++, Metaware
  149.         C, and others, is suitable for porting, because various parts of
  150.         the X DLLs rely on certain features only present with EMX.
  151.  
  152.   5.  Installing the System
  153.  
  154.   The binary distribution is composed of a number of zip archives which
  155.   are the executables, servers, fonts, libraries, include files, man
  156.   pages, and config files.  The full distribution requires about 40-55MB
  157.   of disk space.
  158.  
  159.   All archives of this alpha version are packed with the info-zip
  160.   utility, which is available under the name UNZ512X2.EXE from many OS/2
  161.   archives.  Please obtain a native OS/2 version of this unpacker. DOS
  162.   PKUNZIP does not work, because it cannot unpack long file names and
  163.   extended attributes.
  164.  
  165.   At this moment, the distribution covers only the ``core'' distribution
  166.   which somewhat reduces the usability. Some of the more interesting
  167.   clients from the ``contrib'' area will be made available in the
  168.   future.
  169.  
  170.   The contents of the packages are:
  171.  
  172.  
  173.      REQUIRED:
  174.  
  175.         312Dbase
  176.            A special device driver and the SuperProbe program
  177.  
  178.         312Ddoc
  179.            READMEs and XFree86 specific man pages.
  180.  
  181.         312Dbin
  182.            all of the executable X client applications and shared libs
  183.  
  184.         312Dfnts
  185.            the misc and 75dpi fonts
  186.  
  187.         312Dlib
  188.            data files needed at runtime
  189.  
  190.         emxrt
  191.            Runtime libraries of EMX
  192.  
  193.         Choose at least one of the following to match your hardware:
  194.  
  195.  
  196.         312D8514
  197.            the X server for IBM 8514/A and compatible boards
  198.  
  199.         312DAGX
  200.            the X server for AGX boards
  201.  
  202.         312DI128
  203.            the X server for #9 Imagination 128 boards
  204.  
  205.         312DMa32
  206.            the X server for ATI Mach32 graphics boards
  207.  
  208.         312DMa64
  209.            the X server for ATI Mach64 graphics boards
  210.  
  211.         312DMa8
  212.            the X server for ATI Mach8 graphics boards
  213.  
  214.         312DMono
  215.            the Monochrome X Server
  216.  
  217.         312DP9K
  218.            the X server for P9000 based boards
  219.  
  220.         312DS3
  221.            the X server for S3 based boards
  222.  
  223.         312DSvga
  224.            the 8-bit pseudo-color X server for Super VGA cards
  225.  
  226.         312Dvg16
  227.            the 4-bit pseudo-color X server for VGA & SVGA cards.
  228.  
  229.         312Dw32
  230.            the X server for et4000w32 based boards
  231.  
  232.      OPTIONAL:
  233.  
  234.         312Dman
  235.            pre-formatted man pages for the X11 interface and clients
  236.  
  237.         312Df100
  238.            100dpi fonts
  239.  
  240.         312Dfscl
  241.            Speedo and Type1 fonts
  242.  
  243.         312Dfnon
  244.            Japanese, Chinese and other fonts
  245.  
  246.         312Dfcyr
  247.            Cyrillic fonts
  248.  
  249.         312Dfsrv
  250.            the font server with man pages.
  251.  
  252.         312Dprog
  253.            the X11 header files and programmer's utilities for compiling
  254.            other X applications
  255.  
  256.         312Dpex
  257.            PEX fonts and libraries required for PEX applications
  258.  
  259.         312Dnest
  260.            the Xnest X server
  261.  
  262.   In order to save space on your disk and reduce net bandwidth, choose
  263.   the software to obtain carefully. Each X server is an archive of about
  264.  
  265.   1.4MB and occupies 2.5MB on the disk. You won't normally need more
  266.   than the single Xserver tailored to your video card.
  267.  
  268.   If it is your first time install, get the 312Dbase archive before any
  269.   of the other packages. This package contains a driver and a test
  270.   program, which analyzes your video hardware. If this program fails or
  271.   reports an incompatible hardware, it makes no sense to obtain the
  272.   other packages in the hope that they would magically work.
  273.  
  274.   6.  Checking Compatibility of Video Hardware
  275.  
  276.   In the following, we assume that you want to install XFree86/OS2 on a
  277.   disk drive with the letter Y: (which you probably don't have). Change
  278.   the letter in all commands accordingly.
  279.  
  280.  
  281.      1. Obtain the package 312Dbase and install it from the root
  282.         directory of the Y: drive, by entering the following commands:
  283.  
  284.  
  285.           [C:\] Y:
  286.           [Y:\] cd \
  287.           [Y:\] unzip \path_of_package\312Dbase.zip
  288.  
  289.  
  290.  
  291.  
  292.  
  293.      2. Edit your CONFIG.SYS file to contain the following line
  294.         somewhere:
  295.  
  296.  
  297.           DEVICE=Y:\XFree86\lib\xf86sup.sys
  298.  
  299.  
  300.  
  301.  
  302.      Of course replace ``Y:'' with the correct drive letter.
  303.  
  304.      3. At this point, you may consider to add the variables required
  305.         for XFree86/OS2 as well, which will save you from one additional
  306.         reboot.  Refer to section ``Adding Variables to CONFIG.SYS''
  307.         below.
  308.  
  309.      4. After adding the device driver entry to the CONFIG.SYS file, you
  310.         must reboot to install the driver. XFree86/OS2 will not work
  311.         without this driver.
  312.  
  313.      5. Start a full screen OS/2 CMD session and enter the following
  314.         command:
  315.  
  316.  
  317.           [C:\] Y:\XFree86\bin\SuperProbe
  318.  
  319.  
  320.  
  321.  
  322.  
  323.      6. This command will (normally) report important information about
  324.         your video configuration, i.e. the type of chipset, the
  325.         available video memory and the RAMDAC circuit available. Please
  326.         write this down or redirect the output of ``SuperProbe'' into a
  327.         file by entering:
  328.  
  329.  
  330.  
  331.      [C:\] Y:\XFree86\bin\SuperProbe >filename
  332.  
  333.  
  334.  
  335.  
  336.  
  337.      7. SuperProbe can identify many more video cards than are supported
  338.         by XFree86. Therefore lookup the reported type in the
  339.         compatibility list, and also check the accompanying README.*
  340.         files for special conditions and requirements. If the card is
  341.         not mentioned or marked as unsupported, the game is over for you
  342.         now, unfortunately.
  343.  
  344.      8. Otherwise chances are good, that you can run XFree86/OS2. Obtain
  345.         the rest of the software and proceed with the next section.
  346.  
  347.   7.  Installing the packages
  348.  
  349.   XFree86/OS2 assumes a directory hierarchy starting from
  350.   drive:\XFree86.  This can be changed, but is strictly discouraged.
  351.  
  352.  
  353.      1. Choose a HPFS partition with sufficient free space.
  354.  
  355.      2. For each package to install, go to the root directory of this
  356.         drive, and type:
  357.  
  358.  
  359.           drive:> cd \
  360.           drive:> unzip \path_of_packages\312Dxxxx.zip
  361.  
  362.  
  363.  
  364.  
  365.   8.  Adding Variables to CONFIG.SYS
  366.  
  367.   XFree86/OS2 requires a number of settings in the CONFIG.SYS file to
  368.   work correctly. Please add the following settings:
  369.  
  370.  
  371.      TERM
  372.         Set the preferred terminal type for the xterm or editor to be
  373.         used.  Some programs need this setting. I have my type set to
  374.  
  375.  
  376.           SET TERM=ansi
  377.  
  378.  
  379.  
  380.  
  381.      \XFree86\lib\X11\etc\termcap.x11 contains a suitable termcap which
  382.      can be used in place of termcap files that come with EMX, EMACS, or
  383.      other ported software.
  384.  
  385.      TERMCAP
  386.         This variable must be set to the location where the termcap file
  387.         used for the above TERM variable is searched. My setting, for
  388.         instance, is:
  389.  
  390.  
  391.           SET TERMCAP=D:/EMX/ETC/TERMCAP.X11
  392.  
  393.  
  394.  
  395.  
  396.  
  397.      Note that forward ``/'' is used as a directory separator.
  398.  
  399.      ETC
  400.         Set to an ETC directory. Normally, this is already set to the
  401.         ETC directory of the TCP/IP code, such as
  402.  
  403.  
  404.           SET ETC=C:\TCPIP\ETC
  405.  
  406.  
  407.  
  408.  
  409.      TMP
  410.         Set to an TMP directory. Normally, this is already set to the
  411.         TMP directory of the TCP/IP code, such as
  412.  
  413.  
  414.           SET TMP=C:\TCPIP\TMP
  415.  
  416.  
  417.  
  418.  
  419.      HOSTNAME
  420.         Set to the internet hostname. Normally, this is already set by
  421.         the TCP/IP installation program, such as
  422.  
  423.  
  424.           SET HOSTNAME=myhost
  425.  
  426.  
  427.  
  428.  
  429.      With IAK, you would normally run a loopback configuration ``Network
  430.      configuration'' and would then set this to
  431.  
  432.  
  433.           SET HOSTNAME=localhost
  434.  
  435.  
  436.  
  437.  
  438.      USER
  439.  
  440.      LOGNAME
  441.         Set both to a username. Currently, they are there just to make
  442.         some programs happy; in the future, this variable might be set
  443.         by a login shell of a multiuser configuration. My variable, for
  444.         instance, is set to
  445.  
  446.  
  447.                   SET USER=holger
  448.                   SET LOGNAME=holger
  449.  
  450.  
  451.  
  452.  
  453.      HOME
  454.         Set this to an existing directory that is supposed to be a home
  455.         directory of a user. Some utilities place temporary and init
  456.         files here. This is also future investment for a multiuser
  457.         configuration, but must still be there. For instance, this
  458.         variable might be set to
  459.  
  460.  
  461.  
  462.  
  463.      SET HOME=H:\user\holger
  464.  
  465.  
  466.  
  467.  
  468.      X11ROOT
  469.         This is one of the most important settings, it determines the
  470.         root of the XFree86 directory tree. Normally, you will set this
  471.         to the drive letter of the partition where the \XFree86 tree
  472.         resides, such as in
  473.  
  474.  
  475.           SET X11ROOT=Y:
  476.  
  477.  
  478.  
  479.  
  480.      You may try to move the tree to another subdirectory, e.g. to
  481.      K:\OS2\X11\XFree86... and would then have to change this to
  482.  
  483.  
  484.           SET X11ROOT=K:/OS2/X11
  485.  
  486.  
  487.  
  488.      , but this is discouraged, since some utilities might not accept
  489.      this.  Note the forward ``/'' as a directory separator here.
  490.  
  491.      DISPLAY
  492.         This variable may be set to the display to be used for
  493.         displaying clients. Normally you will set this variable to the
  494.         same value as the HOSTNAME variable and simply add a :0.0 after
  495.         it, such as
  496.  
  497.  
  498.           SET DISPLAY=myhost:0.0
  499.  
  500.  
  501.  
  502.  
  503.      Read the X11 man page on the exact meaning of these postfixes and
  504.      other options.
  505.  
  506.      XSERVER
  507.         Set this to the executable name of the X server to be used. This
  508.         must be a complete path. My setting is as follows:
  509.  
  510.  
  511.           SET XSERVER=D:/XFree86/bin/XF86_Mach64.exe
  512.  
  513.  
  514.  
  515.  
  516.      PATH
  517.         Add the binary directory for the X11 utilities to your search
  518.         PATH.  This is normally the directory (adjust the letter)
  519.  
  520.  
  521.           Y:\XFree86\bin
  522.  
  523.  
  524.  
  525.  
  526.      It is possible to move the binaries to another directory in the
  527.      search path; for maintenance reasons and clarity of the structure,
  528.  
  529.      this is not recommended, though.
  530.  
  531.      LIBPATH
  532.         Add the DLL directory for the X11 utilities to the LIBPATH.
  533.         This is normally the directory (adjust the letter)
  534.  
  535.  
  536.           Y:\XFree86\lib
  537.  
  538.  
  539.  
  540.  
  541.      It is possible to move the DLLs to another directory in the library
  542.      path; for maintenance reasons and clarity of the structure, this is
  543.      not recommended, though. Note that Y:\XFree86\lib has several other
  544.      subdirectories; these may not be moved elsewhere, rather they must
  545.      stay there, because most utilities form a path to these directories
  546.      by using %X11ROOT%\XFree86\lib as a base.
  547.  
  548.   9.  Remarks on the Network Configuration
  549.  
  550.   It is beyond the scope of this document to even give an introduction
  551.   about the correct installation of the TCP/IP networking system. You
  552.   must do this yourself or seek assistance elsewhere. It is only
  553.   possible to say here that a PC working well in a TCP/IP based LAN
  554.   network will also work with XFree86/OS2 (when all other prerequisites
  555.   are matched as well).
  556.  
  557.   With IAK, there is a special configuration necessary, unless you want
  558.   to use XFree86/OS2 only during a hot link to your Internet provider,
  559.   the so called ``localhost'' or ``loopback'' configuration. This is a
  560.   local network interface which ``loops'' back to the same host. The
  561.   following settings are necessary for this:
  562.  
  563.  
  564.      1. Create a file \tcpip\etc\hosts with the following content:
  565.  
  566.  
  567.           127.0.0.1  localhost
  568.  
  569.  
  570.  
  571.  
  572.      2. Add the following line to your \tcpip\bin\tcpstart.cmd:
  573.  
  574.  
  575.           ifconfig lo 127.0.0.1 up
  576.  
  577.  
  578.  
  579.  
  580.      3. Uncomment the inetd process in the same file.
  581.  
  582.      4. Set the HOSTNAME environment variable to localhost as described
  583.         in the last section.
  584.  
  585.      5. Add the following line to CONFIG.SYS:
  586.  
  587.  
  588.           SET USE_HOSTS_FIRST=1
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.      6. After rebooting, verify that the following command works:
  596.  
  597.  
  598.           [C:\] ping localhost
  599.  
  600.  
  601.  
  602.  
  603.   If you have problems to get this or other basic networking things
  604.   running, seek assistance elsewhere.
  605.  
  606.   10.  Configuring X for Your Hardware
  607.  
  608.   After you have added the required settings and setup a working
  609.   network, run the xf86config program to create a standard configuration
  610.   file in Y:\XFree86\lib\X11\XConfig from a windowed or full screen OS/2
  611.   text session:
  612.  
  613.  
  614.        [C:\] xf86config
  615.  
  616.  
  617.  
  618.  
  619.   This program will ask a number of questions. You will need the
  620.   information obtained from the SuperProbe program here. The program
  621.   should be self explanatory; if you have problems to understand
  622.   something though, seek assistance in the newsgroups.
  623.  
  624.   Alternatively, but not recommended for the non-expert, you can edit
  625.   the XConfig file manually with a text editor. A sample file is in
  626.   Y:\XFree86\lib\X11\XConfig.eg, which can be used as a starting point.
  627.  
  628.   For details about the XF86Config file format, refer to the
  629.   XF86Config(4/5) manual page.
  630.  
  631.   If you know the configuration process from Linux or other XFree86
  632.   platform, you will encounter a few differences:
  633.  
  634.      o  There is no configuration for the mouse type or device. The
  635.         mouse device name is fixed to OSMOUSE, and this cannot be
  636.         changed.  If you have a three-button-mouse, install the correct
  637.         OS/2 driver for it, such as
  638.  
  639.  
  640.           DEVICE=D:\OS2\BOOT\PCLOGIC.SYS SERIAL=COM1
  641.           DEVICE=D:\OS2\BOOT\MOUSE.SYS TYPE=PCLOGIC$
  642.  
  643.  
  644.  
  645.  
  646.      for a MouseSystems compatible mouse, for instance.
  647.  
  648.      o  Currently, the X server does not read the native OS/2 keyboard
  649.         map, so you need a xmodmap file for a non-us keyboard.
  650.         Fortunately, it is the same you use for Linux. The server is
  651.         compiled with the XKEYBOARD option, so this might be an
  652.         alternative. At the time of this documentation, unfortunately,
  653.         some subtle bug in the OS/2 implementation is still waiting for
  654.         a fix, so this might not yet work. Read the LATEST.OS2 file with
  655.         the binary distribution.
  656.  
  657.      o  There is no support for the Wacom and Elographics input devices
  658.         yet.
  659.  
  660.  
  661.   Other than that, an existing XF86Config file for the same XFree86
  662.   version from Linux or another platform may be used without changes.
  663.  
  664.   Once you've set up a XF86Config file, you can fine tune the video
  665.   modes with the xvidtune utility.
  666.  
  667.   11.  Running X
  668.  
  669.   16mb of memory is a recommended minimum for running the network
  670.   software, X and the presentation manager in parallel.  The server,
  671.   window manager and an xterm take about 4-6 Mb of memory themselves.  X
  672.   will start up on a system with 8MB or less, but the performance will
  673.   severely suffer from heavy disk swapping. Your mileage may vary,
  674.   though, so some people might consider this still tolerable.
  675.  
  676.   The easiest way for new users to start X windows is to type:
  677.  
  678.  
  679.        [C:\] startx
  680.  
  681.  
  682.  
  683.  
  684.   To get out of X windows, type: ``exit'' in the console xterm.  You can
  685.   customize your X by creating .xinitrc, .xserverrc, and .twmrc files in
  686.   the directory that the HOME environment variable points to. These
  687.   files are described in the xinit and startx man pages.
  688.  
  689.   12.  Rebuilding the XFree86 Distribution
  690.  
  691.   Do you really want to rebuild XFree86/OS2 from source? If so, here are
  692.   a few hints:
  693.  
  694.      1. You need about 250-300 MB of free HPFS space.
  695.  
  696.      2. You must have the complete EMX environment installed.
  697.  
  698.      3. You need most of the GNU utilities that are available from the
  699.         unix directory of hobbes.nmsu.edu.
  700.  
  701.      4. You need a GNU make 3.71 or 3.72, others often have obscure
  702.         bugs.  You cannot use dmake, nmake, wmake, or other toy software
  703.         as a replacement.
  704.  
  705.      5. Install the X11R6.1 ``core'' distribution on some disk under a
  706.         directory like \X11, i.e.  \X11\xc\....
  707.  
  708.      6. Copy the cmd file buildos2.cmd from the directory
  709.         \X11\xc\config\util to the top directory \X11\xc.
  710.  
  711.      7. Execute this script; this should recompile everything, thereby
  712.         producing a logfile \X11\xc\buildxc.log.  The process requires
  713.         between 2 and 20 hours depending on your hardware.
  714.  
  715.   Good luck!
  716.  
  717.   13.  Building New X Clients
  718.  
  719.   The easiest way to build a new client (X application) is to use xmkmf
  720.   if an Imakefile is included in the sources.  Type ``xmkmf -a'' to
  721.   create the Makefiles, check the configuration if necessary and type
  722.   ``xmake''. ``xmake'' is a wrapper for the GNU make program which
  723.   defeats the improper SHELL setting typically found in a Makefile
  724.   generated from an Imakefile.
  725.  
  726.  
  727.   14.  Acknowledgements
  728.  
  729.   Many thanks to:
  730.  
  731.      o  Sebastien Marineau for his great work on getting the server code
  732.         debugged
  733.  
  734.      o  Eberhard Mattes for the wonderful base platform EMX which this
  735.         port heavily relies on
  736.  
  737.      o  ME - no, no, forget this: I won't praise myself :-)
  738.  
  739.  
  740.   Generated from XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/OS2.sgml,v 3.4 1996/03/10 12:05:04 dawes Exp $
  741.  
  742.  
  743.  
  744.  
  745.  
  746.   $XConsortium$
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794. $XFree86: xc/programs/Xserver/hw/xfree86/doc/README.OS2,v 3.7 1996/03/17 13:02:35 dawes Exp $
  795.